Patterns for Denoting Phone Numbers and SIP URIs

The table below lists the supported patterns (notations) that you can use in various configuration tables for matching rules, based on source and/or destination phone numbers and SIP URIs (user@host parts).

When configuring phone numbers in the Web interface, enter them only as digits without any other characters. For example, if you wish to enter the phone number 555-1212, type it as 5551212 without the hyphen (-). If the hyphen is entered, the entry is invalid.

Supported Patterns for Phone Numbers and SIP URIs

Pattern

Description

x (letter "x")

Wildcard that denotes any single digit or character.

# (pound symbol)

When located at the end of a pattern, it denotes the end of a number. For example, 54324# denotes a 5-digit number that starts with the digits 54324.
When located anywhere in the pattern except at the end, it is part of the number (pound key). For example, 3#45 represents the prefix number 3#45.
To denote the # key when it appears at the end of the number, enclose it in square brackets. For example, 134[#] denotes any number that starts with 134#.

* (asterisk symbol)

When used on its own, it denotes any number or string.
When used as part of a number, it denotes the asterisk (*) key. For example, *345 denotes a number that starts with *345.

$ (dollar sign)

For incoming IP calls: Denotes a Request-URI that doesn't have a user part.

This pattern is used for the following matching criteria:

Source and Destination Phone
Source and Destination Username
Source and Destination Calling Name

Range of Digits

Note:

To denote a prefix that is a range, enclose it in square brackets, for example, [4-8] or 23xx[456].
To denote a prefix that is not a range, do not enclose in brackets, for example, 12345#.
To denote a suffix, enclose it in parenthesis, for example, (4) and (4-8).
To denote a suffix that includes multiple ranges, enclose the range in square brackets, for example, (23xx[4,5,6]).

Example of using both a prefix and a suffix in a pattern: Assume you want to match a rule whose destination phone prefix is 4 through 8, and suffix is 234, 235, or 236. The pattern for this would be: [4-8](23[4,5,6]).

[n-m] or (n-m)

Denotes a range of numbers.

Examples:

To denote prefix numbers from 5551200 to 5551300:
[5551200-5551300]#
To denote prefix numbers from 123100 to 123200:
123[100-200]#
To denote prefix and suffix numbers together:
03(100): for any number that starts with 03 and ends with 100.
[100-199](100,101,105): for a number that starts with 100 to 199 and ends with 100, 101 or 105.
03(abc): for any number that starts with 03 and ends with abc.
03(5xx): for any number that starts with 03 and ends with 5xx.
03(400,401,405): for any number that starts with 03 and ends with 400 or 401 or 405.

Note:

The value n must be less than the value m.
Only numerical ranges are supported (not letters).
For suffix ranges, the starting (n) and ending (m) numbers in the range must include the same number of digits. For example, (23-34) is correct, but (3-12) is not.

[n,m] or (n,m)

Denotes multiple numbers. The value can include digits or characters.

Examples:

To denote a one-digit number starting (prefix) with 2, 3, 4, 5, or 6: [2,3,4,5,6]
To denote a one-digit number ending (suffix) with 7, 8, or 9: (7,8,9)
Prefix with suffix: [2,3,4,5,6](7,8,9) - prefix is denoted in square brackets; suffix in parenthesis

For prefix only, the patterns d[n,m]e and d[n-m]e can also be used:

To denote a five-digit number that starts with 11, 22, or 33: [11,22,33]xxx#
To denote a six-digit number that starts with 111 or 222: [111,222]xxx#

[n1-m1,n2-m2,a,b,c,n3-m3] or (n1-m1,n2-m2,a,b,c,n3-m3)

Denotes a mixed pattern of single numbers and multiple number ranges. For example, to denote numbers 123 through 130, 455, 766, and 780 through 790:

Prefix: [123-130,455,766,780-790]
Suffix: (123-130,455,766,780-790)

Note: The ranges and the single numbers in the mixed pattern must have the same number of digits. For example, each number range and single number in the examples above consists of three digits (e.g., 780).

Special ASCII Characters

The device doesn't support the use of ASCII characters in manipulation rules and therefore, for LDAP-based queries, the device can use the hexadecimal (HEX) format of the ASCII characters for phone numbers instead. The HEX value must be preceded by a backslash “\”.

For example, you can configure a manipulation rule that changes the received number +49 (7303) 165-xxxxx to +49 \287303\29 165-xxxxx, where \28 is the ASCII HEX value for “(“ and \29 is the ASCII HEX value for “)”. The manipulation rule in this example would denote the parenthesis in the destination number prefix using "x" wildcards (e.g., xx165xxxxx#); the prefix to add to the number would include the HEX values (e.g., +49 \287303\29 165-).

Below is a list of common ASCII characters and their corresponding HEX values:

*: \2a
(: \28
): \29
\: \5c
/: \2f